package com.ruoyi.system.mapper;

import java.util.List;

import com.ruoyi.system.domain.*;
import com.ruoyi.system.domain.vo.MessageQuery;
import com.ruoyi.system.dto.GroupAssistantMessageHistoryDTO;
import org.apache.ibatis.annotations.Param;

/**
 * 【请填写功能名称】Mapper接口
 * 
 * @author ruoyi
 * @date 2025-08-18
 */
public interface TMessagesMapper 
{
    /**
     * 查询【请填写功能名称】
     * 
     * @param id 【请填写功能名称】主键
     * @return 【请填写功能名称】
     */
    public TMessages selectTMessagesById(Long id);
    
    /**
     * 根据ID和表名查询消息（支持分表）
     * 
     * @param id 消息主键
     * @param tableName 表名
     * @return 消息
     */
    public TMessages selectTMessagesById(@Param("id") Long id, @Param("tableName")String tableName);

    /**
     * 跨分表联合查询消息列表，支持分页
     *
     * @param  query 查询条件
     * @param tableName 表名集合（例如 t_messages_0...t_messages_35）
     * @param offset 偏移量
     * @param limit 每页条数
     * @return 消息集合
     */
    List<TMessages> selectUnionMessages(@Param("query") MessageQuery query,
                                               @Param("tableName") String tableName,
                                               @Param("offset") int offset,
                                               @Param("limit") int limit);

    /**
     * 跨分表联合统计总数
     *
     * @param query 查询条件
     * @param tableName 表名集合
     * @return 总数量
     */
    public Long countUnionMessages(@Param("query") MessageQuery query,
                                   @Param("tableName") String tableName);

    /**
     * 根据ID集合批量查询指定表中的消息
     *
     * @param ids ID集合
     * @param tableName 表名
     * @return 消息集合
     */
    public List<TMessages> selectTMessagesByIds(@Param("ids") List<Long> ids,
                                                @Param("tableName") String tableName);

    /**
     * 查询指定分表中的消息（按_dt倒序，限制条数）
     *
     * @param query 查询条件（可选 uid、必选 type、beginTime、endTime）
     * @param tableName 分表名（如 t_messages_2025_08）
     * @param limit 预裁剪条数
     * @return 该分表的消息集合
     */
    List<TMessages> selectMessagesInTable(@Param("query") MessageQuery query,
                                          @Param("tableName") String tableName,
                                          @Param("limit") int limit);

    /**
     * 仅查询键（id、_dt）以便归并后再批量取详情
     *
     * @param query 查询条件
     * @param tableName 分表名
     * @param limit 预裁剪条数
     * @return 仅含 id 与 dt 的消息键集合
     */
    List<TMessages> selectMessageKeysInTable(@Param("query") MessageQuery query,
                                             @Param("tableName") String tableName,
                                             @Param("limit") int limit);

    /**
     * 新增【请填写功能名称】
     * 
     * @param tMessages 【请填写功能名称】
     * @return 结果
     */
    public int insertTMessages(TMessages tMessages);

    /**
     * 修改【请填写功能名称】
     * 
     * @param tMessages 【请填写功能名称】
     * @return 结果
     */
    public int updateTMessages(TMessages tMessages);

    /**
     * 删除【请填写功能名称】
     * 
     * @param id 【请填写功能名称】主键
     * @return 结果
     */
    public int deleteTMessagesById(Long id);

    /**
     * 批量删除【请填写功能名称】
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteTMessagesByIds(Long[] ids);

    void insertSendMessage(SendHistory sendHistory);

    /**
     * 查看群发消息记录
     * @param category
     * @return
     */
    List<SendHistory> getSendGroupMessageList(Integer category);

    /**
     * 保存群助手消息记录
     * @param history
     */
    void insertGroupAssistantMessageHistory(GroupAssistantMessageHistory history);

    /**
     * 根据用户ID数组查询用户名称
     * @param split
     * @return
     */
    List<TUser> getUserNameByUserIds(String[] split);

    /**
     * 查看群助手消息记录
     * @param senderId
     * @return
     */
    List<GroupAssistantMessageHistoryDTO> getGroupAssistantMessageHistory(String senderId);

    /**
     * 删除群助手消息记录
     * @param id
     * @return
     */
    int deleteGroupAssistantMessageHistory(String id);
}
